home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / msdos / colrd152.zip / COLORDOS.DOC < prev    next >
Text File  |  1993-06-21  |  42KB  |  1,007 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                   COLORDOS  1.52
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                     _______
  34.                                ____|__     |               (R)
  35.                             --|       |    |-------------------
  36.                               |   ____|__  |  Association of
  37.                               |  |       |_|  Shareware
  38.                               |__|   o   |    Professionals
  39.                             -----|   |   |---------------------
  40.                                  |___|___|    MEMBER
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                          Copyright (c) 1992,93  by KroTek Electronics
  52.  
  53.  
  54.                              1214 Riverside Dr.  Unit 317
  55.                              Timmins, Ontario, Canada
  56.                              P4R 1A4
  57.                              705 268 7352
  58.  
  59.  
  60.  
  61.                         ColorDOS release 1.52
  62.  
  63.         0.0     Welcome
  64.  
  65.         Thank you for taking the time to download ColorDOS 1.52. Hope-
  66. fully you will find it useful in adding life to your work on the DOS
  67. command line. With the advent of modern VGA color monitors included as a
  68. part of many of today's computer packages, it is surprising that DOS
  69. primarily remains a monochrome operating system.  ColorDOS was written
  70. to overcome some of these limitations.
  71.  
  72.  
  73.         1.0     What is ColorDOS ?
  74.  
  75.         ColorDOS is a set of very small, yet powerful set of TSR
  76. (terminate and stay resident, or memory resident) programs that monitor
  77. the activity of DOS and determine if the command line is present. They
  78. then colorize the command prompt such that every subdirectory and drive
  79. letter in the prompt has its own color. Also, all of the text that comes
  80. after the command prompt can have a unique color for each drive, with or
  81. without ANSI.SYS being installed.
  82.  
  83.         ColorDOS takes up very little memory (as low as 0.8 K) and it
  84. can be loaded in the upper memory with the DOS loadhigh command.
  85. ColorDOS is only active when the command prompt is showing, and is
  86. completely passive when you are running applications. Despite its small
  87. size and transparent operation, ColorDOS' effect are visible every time
  88. you hit return from DOS.
  89.  
  90.  
  91.         1.1      What is Included on This Disk ?
  92.  
  93.         This distribution disk should contain the following sixteen
  94. files:
  95.           1.      Read_me.1st                9.      Colordos.4
  96.  
  97.           2.      Colordos.doc              10.      Colordos.5
  98.  
  99.           3.      Colsetup.com              11.      Colordos.6
  100.  
  101.           4.      Colinstl.com              12.      Colremov.2
  102.  
  103.           5.      Colordos.1                13.      Registr.frm
  104.  
  105.           6.      Colordos.2                14.      Vendor.doc
  106.  
  107.           7.      Colordos.3                15.      Sysop.doc
  108.  
  109.           8.      Colremov.1                16.      Sitelice.doc
  110.  
  111. - If any of these files are missing, please do not redistribute this
  112. package. - The file "Read_me.1st" contains information on how to quickly
  113. get ColorDOS up and running on your system. - For more detail on the
  114. contents or function of these files, please see appendicies B and C.
  115.  
  116.  
  117.  
  118. ColorDOS 1.5 User Manual                -2-           KroTek Electronics
  119.  
  120.  
  121.         2.0     Table of Contents
  122.  
  123.  
  124.  
  125.  
  126.  
  127.         0.0     Welcome ................................... Page 2
  128.  
  129.         1.0     What is ColorDOS .......................... Page 2
  130.  
  131.         2.0     Table of Contents ......................... Page 3
  132.  
  133.         3.0     Installing ColorDOS ....................... Page 4
  134.  
  135.                 3.1 Running ColInstl ...................... Page 4
  136.  
  137.                 3.2 Loading ColorDOS ...................... Page 6
  138.  
  139.                 3.3 Unloading ColorDOS .................... Page 6
  140.  
  141.                 3.4 Running ColSetup ...................... Page 6
  142.  
  143.                 3.5 ColSetup Features ..................... Page 8
  144.  
  145.         4.0     Video Modes ............................... Page 9
  146.  
  147.         5.0     Incompatibilities ......................... Page 10
  148.  
  149.                 5.1 ColorDOS and DOSKey ................... Page 10
  150.  
  151.         6.0     Disclaimer ................................ Page 10
  152.  
  153.         7.0     Registration .............................. Page 10
  154.  
  155.                 7.1 Copyright ............................. Page 10
  156.  
  157.                 7.2 Price ................................. Page 11
  158.  
  159.                 7.3 Software Support ...................... Page 11
  160.  
  161.                 7.4 Distribution .......................... Page 11
  162.  
  163.         8.0     About ColorDOS ............................ Page 12
  164.  
  165.         9.0     Ombudsman & ASP Information ............... Page 12
  166.  
  167.         Appendix A - Definition of Shareware .............. Page 12
  168.  
  169.         Appendix B - Description of ColorDOS Files ........ Page 14
  170.  
  171.         Appendix C - Setting Environment Variables ........ Page 15
  172.  
  173.         Appendix D - Description of ColorDOS 'Drivers' .... Page 16
  174.  
  175.  
  176.  
  177. ColorDOS 1.5 User Manual                -3-           KroTek Electronics
  178.  
  179.  
  180.         3.0  Installing ColorDOS
  181.  
  182.  
  183.                         3.1     Running ColInstl
  184.  
  185.         The first step to installing ColorDOS on your computer is
  186. the installation program, colinstl.com. ColInstl will automatically
  187. create a batch file that can be run to set your "prompt" and the
  188. "colordos" environment variables, and install the appropriate ColorDOS
  189. tsr program in upper or lower memory, depending on your system.  The
  190. installation program also will create a destination directory and copy
  191. all of the program files to it. To determine information about your
  192. system, ColInstl presents a series of settings that you can accept, or
  193. step through and change to suit your needs.
  194.  
  195.         Use the arrow keys to step though the following settings and
  196. edit them as follows: You can obtain help on any item by pressing F1
  197. with the cursor over the setting in question.
  198.  
  199.          1.     CPU type - This is the microprocessor that your system
  200.                         is running. This should be accurate, and cannot
  201.                         be changed.
  202.  
  203.          2.     DOS version - The version of DOS that is running also
  204.                         cannot be edited.
  205.  
  206.          3.     Video mode - The video card detected by the install-
  207.                         ation program, can't be changed.
  208.  
  209.          4.     Use video BIOS - This is normally not necessary, and so
  210.                         the default is 'no', as it is faster to use
  211.                         ColorDOS' normal method of writing color changes
  212.                         directly to the video memory. If you suspect
  213.                         that you need to use the video BIOS, then toggle
  214.                         this option on with the F2 key.
  215.  
  216.          5.     Text colorization - everything that appears on the
  217.                         screen after the command prompt can be given a
  218.                         unique color that changes as you change drives.
  219.                         If you do not want this option, toggle it off
  220.                         with the F2 key.
  221.  
  222.          6.     Ansi.sys Status - ColInstl can detect ansi.sys only if
  223.                         it is the version origionally shipped with DOS
  224.                         and that version of DOS is greater than 4.0. If
  225.                         ansi.sys status is incorrectly reported, then
  226.                         toggle it with the F2 key.
  227.  
  228.          7.     Command processor - In addition to command.com (which is
  229.                         shipped with DOS), ColorDOS can be run under
  230.                         4DOS, an alternative command processor from JP
  231.                         Software. If the installation program detects
  232.                         4DOS it will also report its version number.
  233.                         Toggling this setting should not be necessary as
  234.                         ColInstl will accurately detect the processor
  235.                         installed, but it can be done with the F2 key.
  236.  
  237. ColorDOS 1.5 User Manual                -4-           KroTek Electronics
  238.  
  239.  
  240.          8.     Prompt envir setting - This is read from your system if
  241.                         you have previously set the prompt, otherwise it
  242.                         defaults to $P$G. The cursor changes color to
  243.                         indicate that you are in a line editor that you
  244.                         can use to edit the prompt setting. Exit the
  245.                         editor by moving the cursor up or down with the
  246.                         arrow keys.
  247.  
  248.          9.     Installation source - This is the source where the
  249.                         ColorDOS files will be copied from. It is
  250.                         the active drive and directory at the time
  251.                         that ColInstl is run, and cannot be
  252.                         edited.
  253.  
  254.         10.     Path to ColorDOS files - This is the destination
  255.                         directory for the files copied or created by the
  256.                         installation program, and also for the color
  257.                         configuration file created by the ColSetup
  258.                         program. If you have set the colordos environ-
  259.                         ment variable, the path is read from your
  260.                         system.  If the environment is not set the
  261.                         destination defaults to C:\DOS\COLORDOS. Running
  262.                         the batch file will set the colordos env
  263.                         variable to what you specify here. Like the
  264.                         prompt setting, you are automatically in a line
  265.                         editor when you move the cursor to this posit-
  266.                         ion, and the up arrow will exit you from this
  267.                         editor.
  268.  
  269.         Once you have answered all of the questions, then you can start
  270. the installation process as follows using the following keys:
  271.  
  272.         F1      Help - Gives online help on the setting that is about to
  273.                         be edited.
  274.  
  275.         F2      Toggle - Switch between the options available for the
  276.                         use of the video bios, text colorization,
  277.                         ansi.sys status, and the command processor.
  278.  
  279.         F3      Install - Copies the files over to the destination
  280.                         directory. A file that is successfully copied is
  281.                         indicated by a green check beside the file name,
  282.                         a red 'R' indicates an error reading the source
  283.                         file and a red 'W' indicates an error writing
  284.                         to the new file. A series of W's at the end of
  285.                         an installation probably indicates a full
  286.                         destination disk.
  287.  
  288.         F4      Make Batch - Creates a batch file named COLSTART.BAT
  289.                         that can be run to automatically set the
  290.                         environment variables and load ColorDOS. You can
  291.                         add this file to the end of your autoexec.bat
  292.                         file so that ColorDOS loads every time you start
  293.                         your system.
  294.  
  295.         F5      Quit - Exit the installation program.
  296.  
  297.  
  298. ColorDOS 1.5 User Manual                -5-           KroTek Electronics
  299.  
  300.  
  301.         F7      Insert - Text insert mode for the line editors that edit
  302.                         the prompt and destination path.
  303.  
  304.         F8      Overwrite - Text overwrite mode for the line editors.
  305.                         The insert key will also toggle between insert
  306.                         and overwrite modes.
  307.  
  308.  
  309.                         3.2     Loading ColorDOS in Memory
  310.  
  311.         The next step is to actually load the memory resident portion of
  312. ColorDOS. This is done by simply running the batch file created by the
  313. ColInstl program. Type "COLSTART" at the command line and the next
  314. prompt will be in the default ColorDOS colors. In addition to loading
  315. ColorDOS into memory, the ColStart batch file also sets the prompt and
  316. the COLORDOS environment variables.
  317.  
  318.  
  319.  
  320.  
  321.                         3.3     Unloading ColorDOS
  322.  
  323.         If you no longer require ColorDOS and wish to remove it from
  324. memory, then you can run the ColRemove utility by typing 'colremov' at
  325. the DOS prompt. ColorDOS will be unloaded and it's allocated memory will
  326. be returned to the operating system. You can then reinstall ColorDOS if
  327. you wish to use changes that you've made with ColSetup.
  328.  
  329.         ColRemov will work if ColorDOS is installed in conventional or
  330. upper memory. However, if there are other TSR's that are installed after
  331. ColorDOS, then you will not be able to unload ColorDOS until you have
  332. removed the programs installed after it.
  333.  
  334.  
  335.  
  336.                         3.4     Running ColSetup
  337.  
  338.         Unless you are happy with the default color settings you will
  339. want to create your own. This is done by running the program called
  340. 'colsetup' which will create a colordos.ini file that contains your
  341. personal settings.
  342.  
  343.         The first thing ColSetup does is look for your previous setup
  344. information. If you have not set the colordos environment variable
  345. ColSetup will also default to the root directory of the C: drive.  The
  346. first time you run the program, you will get an error message saying
  347. ColSetup couldn't find colordos.ini but don't despair, you will soon
  348. create it.
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357. ColorDOS 1.5 User Manual                -6-           KroTek Electronics
  358.  
  359.         When you first start ColSetup, you will see a color grid on the
  360. right and a sample prompt on the left. You will also see a copyright
  361. notice in the upper left, and your computer will pause for 1 second
  362. while you absorb it. After 1 second, you will be given 2 choices:
  363.  
  364.         RETURN  press the enter key if you accept the conditions of the
  365.                   copyright notice
  366.  
  367.         ESCAPE  press the escape key if you do not accept
  368.  
  369.  
  370.         If you press enter, two cursors will appear, Cursor 1 is the
  371. box-like cursor that is used to select a drive letter, subdirectory, or
  372. text color to edit, and Cursor 2 is to select a color from the color
  373. grid to edit what you have selected with cursor 1. Also, your previous
  374. setup colors will be loaded from disk and shown, or any applicable error
  375. messages if there are problems with the environment variable or the
  376. colordos.ini file. Now you can edit your settings using the following
  377. keys:
  378.  
  379.  
  380.         F1              Moves cursor 1 to the right over the sample
  381.                           prompt.
  382.  
  383.         F2              Moves cursor 1 to the left.
  384.  
  385.         F3  &           If cursor 1 is positioned over the drive letter,
  386.         F4                (or sample text, if text color is on) these
  387.                           keys enable the drive letter to be changed in
  388.                           order to enable editing of the drive letters
  389.                           or text colors.
  390.  
  391.         F5 (or Escape)  Quit. If you have made any changes that have not
  392.                           been saved to disk, you will be asked if you
  393.                           want to exit without saving. Just press escape
  394.                           again if you do, any other key will return you
  395.                           to the program.
  396.  
  397.         F6              Save to disk. Your settings are written to a
  398.                           file called colordos.ini in the drive and
  399.                           directory that you specified in the colordos
  400.                           environment variable. If the file already
  401.                           exists, it is overwritten with the new
  402.                           information, if it doesn't exist it is
  403.                           created.
  404.  
  405.         F7              Turns text colorization on. This is the same
  406.                           question as in the installation program, but
  407.                           ColInstl & ColSetup don't talk to each other,
  408.                           so you must repeat yourself here. Thus, if you
  409.                           want ColorDOS to change the color of text
  410.                           after the command prompt use this feature.
  411.                           Some sample text will appear below the prompt
  412.                           and the color can be edited.
  413.  
  414.  
  415.  
  416. ColorDOS 1.5 User Manual                -7-           KroTek Electronics
  417.  
  418.  
  419.         F8              Turns text colorization off. If you have
  420.                           ansi.sys installed, and want uniform text
  421.                           colors regardless of what drive you are on,
  422.                           then this is the option you need. Delete
  423.                           removes the sample text from below the prompt,
  424.                           as it no longer can be edited.
  425.  
  426.         Arrow Keys      Control the position of Cursor 2 over the color-
  427.                           picking grid.
  428.  
  429.         Enter           Edits the color of the drive letter, subdir-
  430.                           ectory, or text selected by Cursor 1 to the
  431.                           color selected by Cursor 2.
  432.  
  433.  
  434.  
  435.  
  436.         Please note that only the file colordos.ini is created with the
  437. save option, if you specify a non-existent path with the colordos
  438. variable, it is not created, you will only get an message specifying a
  439. write error.
  440.  
  441.  
  442.  
  443.         3.3     ColSetup Features
  444.  
  445.         It is possible to set a unique drive color and text color for up
  446. to 12 drives, A: to L:. After L:, the colors reset and start repeating-
  447. so that M: is the same color as A:, and so on, in the following fashion:
  448.  
  449.  
  450.         Color1 .......... A: .... M: .... Y:
  451.         Color2 .......... B: .... N: .... Z:
  452.         Color3 .......... C: .... O:
  453.         Color4 .......... D: .... P:
  454.         Color5 .......... E: .... Q:
  455.         Color6 .......... F: .... R:
  456.         Color7 .......... G: .... S:
  457.         Color8 .......... H: .... T:
  458.         Color9 .......... I: .... U:
  459.         Color10 ......... J: .... V:
  460.         Color11 ......... K: .... W:
  461.         Color12 ......... L: .... X:
  462.  
  463.  
  464.  
  465.  
  466.         ColorDOS can handle up to 8 different subdirectories.  Unlike
  467. the drive letter colors, the subdirectory colors do not 'wrap around' to
  468. subdirectory color 1 after the 8th subdirectory, and the program will
  469. begin to give strange results.
  470.  
  471.  
  472.  
  473.  
  474.  
  475. ColorDOS 1.5 User Manual                -8-           KroTek Electronics
  476.  
  477.         There are not unique directory colors for each drive, the
  478. directory background and foreground colors stay the same no matter what
  479. drive you are on. Only the drive letter, the ":" and the chevron ( > )
  480. change as you switch between drives. (As does the text if it is selected
  481. on). You can, however, keep the same background color for the
  482. directories as you have selected for the drive letter provided all of
  483. the directory colors are chosen from the left most column of the color
  484. grid. ( This is the column with no background color). ColSetup uses the
  485. fact that none of the directories have a background  color as a signal
  486. to fill in all of the prompt with the background color of the drive
  487. letter.
  488.  
  489.  
  490.                          The foreground color of DIR1 (a sample name for
  491.                          the first subdirectory down from the root) in
  492.                          each prompt will stay the same regardless of
  493.                          the drive that you are logged on to. Similarily
  494.                          for DIR2 & 3, etc. However, the background
  495.                          color of all DIR's can be made the same as the
  496.               ___________background color of the drive letters.
  497.              |    |    |
  498.              v    v    v
  499.         C:\DIR1\DIR2\DIR3\...> sample_dos_command
  500.         ^                    ^  ^
  501.         |                    |  |
  502.         |____________________|__|_ Both the foreground and background
  503.                                         color of these items can be
  504.                                         different for each drive in your
  505.         Figure 1  Sample Prompt         system.
  506.  
  507.  
  508.         This feature is useful if you want to make solid screen colors
  509. that are different for each drive. For example, if you want drive C: to
  510. have a solid blue background and drive D: to be solid green, choose a
  511. blue background for the drive letter and text for C:, and a green
  512. background for the drive and text for D:. Then choose directory colors
  513. that contrast well with both blue and green, but pick them from the
  514. left-most column of the color grid, and you're all set.
  515.  
  516.         Once you have everything setup to your satisfaction, press "F6"
  517. to save your settings to disk, and exit ColSetup by pressing F5. In
  518. order for your new color configuration to take effect, it is necessary
  519. to first remove colordos from memory by running the program 'colremov'.
  520. Then reload ColorDOS by running the batch file 'colstart' again. Your
  521. new colors should now be displayed.
  522.  
  523.  
  524.         4.0     Video Modes
  525.  
  526.         ColSetup will run in any color video mode from 80c x 25r to 132c
  527. x 50r. ColorDOS will run in all of these modes and in addition 40c x
  528. 25r, but it must be started in at least 80 x 25. Both of these programs
  529. will run on CGA, EGA, and VGA monitors in color video mode only.
  530.  
  531.  
  532.  
  533.  
  534. ColorDOS 1.5 User Manual                -9-           KroTek Electronics
  535.  
  536.         5.0     Incompatibilities
  537.  
  538.         Every effort is made to ensure compatibility with existing
  539. programs and tsr's that you might have already installed on your system.
  540. However, due to the tremendous variety of TSR's available, it is
  541. impossible to test them all. If you are unfortunate enough to uncover
  542. any incompatibilities or bugs, please let us know, and every effort will
  543. be made to rectify the problem. If possible, please include a listing of
  544. your config.sys and autoexec.bat files. Also, if you have any
  545. criticisms, comments, or features that you would like to see in future
  546. versions, we would very much like to hear from you.  Please write to the
  547. address shown in the registration section.
  548.  
  549.  
  550.                 5.1     ColorDOS and DOSKey
  551.  
  552.         Since version 1.41, ColorDOS is compatible with DOS 5's DOSKey.
  553. However, DOSKey must be loaded into memory before ColorDOS is loaded. If
  554. you are starting DOSKey and ColorDOS from your autoexec file, ensure the
  555. command to load DOSKey comes before the line that loads ColorDOS.
  556.  
  557.  
  558.         6.0     DISCLAIMER - AGREEMENT
  559.  
  560.         Users of ColorDOS must accept this disclaimer of warranty:
  561.  
  562.  
  563.         "COLORDOS IS SUPPLIED AS IS.  THE AUTHOR DISCLAIMS ALL
  564. WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE
  565. WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.  THE
  566. AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OF CONSEQUENTIAL, WHICH
  567. MAY RESULT FROM THE USE OF COLORDOS."
  568.  
  569.  
  570.         7.0     Registration
  571.  
  572.                 7.1     Copyright
  573.  
  574.         This ColorDOS documentation and the software are copyrighted and
  575. all rights are reserved. No part of this documentation or software may
  576. be copied or otherwise reproduced except in the manner described in this
  577. manual.
  578.  
  579.                 Copyright (c) 1992, 1993 by KroTek Electronics
  580.  
  581.  
  582.         ColorDOS has been released as shareware. If you find it useful
  583. and continue to use it after a reasonable trial period, please register
  584. it.
  585.  
  586.         If you obtained this copy of ColorDOS in a self extracting
  587. format it was created by a copyrighted archiving program called LHARC.
  588.  
  589.         LHA     Copyright (c) Haruyasu Yoshizaki, 1988-91
  590.  
  591.  
  592.  
  593. ColorDOS 1.5 User Manual                -10-          KroTek Electronics
  594.  
  595.  
  596.                 7.2     Price
  597.  
  598.         In Canada - CDN$13.50 plus $1.50 shipping and handling per
  599. computer.  In the United States - US$11 plus US$3 shipping and handling.
  600. Internationally - add another US$3 to the US shipping price to offset
  601. additional shipping costs.  You will receive a professionally printed
  602. user's manual as well as prompt notification of future releases of
  603. ColorDOS.  Registered users will also receive a registered version of
  604. the program without the registration notices, delays or beeping.
  605.  
  606.         Please specify disk size when ordering.  There is a registration
  607. form included on the distribution disk for you convenience. Thank you
  608. for your support. Please send your registration to:
  609.  
  610.  
  611.  
  612.        KroTek Electronics             |     Voice         705 268 7352
  613.        1214 Riverside Dr.  Unit 317   |     CompuServe      70620,1755
  614.        Timmins, Ont, Canada           |
  615.        P4R 1A4                        |
  616.  
  617.         ColorDOS makes an excellent gift for anybody with a color monitor.
  618. And, you can save on shipping charges if you order extra copies that are
  619. sent with your registered version. See the file 'registr.frm for details.
  620.  
  621.  
  622.                 7.3     Software Support
  623.  
  624.         Support is available to all registered users of ColorDOS for a
  625. period of 12 months by phoning 1 705 268 7352 (voice or fax) or by
  626. CompuServe email to 70620,1755.
  627.  
  628.  
  629.                 7.4     Distribution
  630.  
  631.         This shareware version of the ColorDOS 1.52 program may be
  632. freely copied and distributed. In fact, your efforts in this regard are
  633. greatly appreciated. However, the following restrictions apply:
  634.  
  635.                 -This program may only be distributed as a complete
  636.                   package, including this documentation file.
  637.  
  638.                 -This program must not be altered in any way, and the
  639.                   copyright notice must remain intact.
  640.  
  641.                 -No charge may be levied for the program beyond a
  642.                   reasonable media and copying fee.
  643.  
  644.  
  645.  
  646.         You are encouraged to pass a copy of ColorDOS along to your friends
  647. for evaluation.  Please encourage them to register their copy if they find
  648. that they can use it.  All registered users will receive a copy of the
  649. latest version of ColorDOS along with a printed manual.
  650.  
  651.  
  652. ColorDOS 1.5 User Manual                -11-          KroTek Electronics
  653.  
  654.  
  655.         8.0     About ColorDOS
  656.  
  657.         ColorDOS was written using the Microsoft Macro Assembler MASM
  658. 6.0. It was written between February and April 1992 to overcome the
  659. limitations of all of the millions of prompt setting utilities that
  660. relied on Ansi.sys.
  661.  
  662.  
  663.         Ver 1.0   01May92     Well, here it is!
  664.  
  665.         Ver 1.1   15May92     ColRemove memory removal utility added.
  666.  
  667.         Ver 1.2 & 1.3         Not released
  668.  
  669.         Ver 1.4   17Jun92     The ability to send ANSI escape sequences
  670.                                 from within ColorDOS is added and 4DOS
  671.                                 compatible versions are added for all
  672.                                 the utilities.
  673.  
  674.         Ver 1.41  01Jul92     DOSKey incomatibility bug fixed, the bios
  675.                                 versions of ColorDOS added.
  676.  
  677.         Ver 1.50  20Feb93     The installation program is added to
  678.                                 automate the choices and system settings
  679.                                 This will ease the initial installation.
  680.  
  681.         Ver 1.52  21Jun93     Install bug fix when installing to root dir's
  682.  
  683.  
  684.         9.0     Ombudsman Statement
  685.  
  686.  
  687.         KroTek Electronics is a member of the Association of Shareware
  688. Professionals (ASP). ASP wants to make sure that the shareware principle
  689. works for you. If you are unable to resolve a shareware- related problem
  690. with an ASP member by contacting the member directly, ASP may be able to
  691. help. The ASP Ombudsman can help you resolve a dispute or problem with
  692. an ASP member, but does not provide technical support for members'
  693. products. Please write to the ASP Ombudsman at 545 Grover Road,
  694. Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to
  695. ASP Ombudsman 70007,3536.
  696.  
  697.  
  698.  
  699.                                 Appendix A
  700.  
  701.                         The Definition of Shareware.
  702.  
  703.         Shareware distribution gives users a chance to try software
  704. before buying it. If you try a Shareware program and continue using it,
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711. ColorDOS 1.5 User Manual                -12-          KroTek Electronics
  712.  
  713. you are expected to register. Individual programs differ on details --
  714. some request registration while others require it, some specify a
  715. maximum trial period. With registration, you get anything from the
  716. simple right to continue using the software to an updated program with
  717. printed manual.
  718.  
  719.         Copyright laws apply to both Shareware and commercial software,
  720. and the copyright holder retains all rights, with a few specific
  721. exceptions as stated below. Shareware authors are accomplished
  722. programmers, just like commercial authors, and the programs are of
  723. comparable quality. (In both cases, there are good programs and bad
  724. ones!) The main difference is in the method of distribution. The author
  725. specifically grants the right to copy and distribute the software,
  726. either to all and sundry or to a specific group. For example, some
  727. authors require written permission before a commercial disk vendor may
  728. copy their Shareware.
  729.  
  730.         Shareware is a distribution method, not a type of software. You
  731. should find software that suits your needs and pocketbook, whether it's
  732. commercial or Shareware. The Shareware system makes fitting your needs
  733. easier, because you can try before you buy.  And because the overhead is
  734. low, prices are low also. Shareware has the ultimate money-back
  735. guarantee -- if you don't use the product, you don't pay for it.
  736.  
  737.         ColorDOS is a "shareware program" and is provided at no charge
  738. to the user for evaluation.  Feel free to share it with your friends,
  739. but please do not give it away altered or as part of another system.
  740. The essence of "user-supported" software is to provide personal computer
  741. users with quality software without high prices, and yet to provide
  742. incentive for programmers to continue to develop new products. If you
  743. find this program useful and find that you are using ColorDOS and
  744. continue to use ColorDOS after a reasonable trial period, you must make
  745. a registration payment of US$11 plus $3 shipping to KroTek Electronics.
  746. The US$11 registration fee will license one copy for use on any one
  747. computer at any one time.  You must treat this software just like a
  748. book.  An example is that this software may be used by any number of
  749. people and may be freely moved from one computer location to another, so
  750. long as there is no possibility of it being used at one location while
  751. it's being used at another.  Just as a book cannot be read by two
  752. different persons at the same time.
  753.  
  754.         Commercial users of ColorDOS must register and pay for their
  755. copies of ColorDOS within 30 days of first use or their license is
  756. withdrawn.  Site-License arrangements may be made by referring to the
  757. file sitelice.doc.
  758.  
  759.         Anyone distributing ColorDOS for any kind of remuneration must
  760. first contact KroTek Electronics at the address above for authorization.
  761. This authorization will be automatically granted to distributors
  762. recognized by the (ASP) as adhering to its guidelines for shareware
  763. distributors, and such distributors may begin offering ColorDOS
  764. immediately (However KroTek Electronics must still be advised so that
  765. the distributor can be kept up-to-date with the latest version of
  766. ColorDOS.).
  767.  
  768.  
  769.  
  770. ColorDOS 1.5 User Manual                -13-          KroTek Electronics
  771.  
  772.                                 Appendix B
  773.  
  774.         An explanation of the files contained in this package.
  775.  
  776.  
  777.           1.      Read_me.1st     Contains the basic steps to quickly
  778.                                     get ColorDOS running.
  779.  
  780.           2.      Colordos.doc    This is the file you are reading
  781.  
  782.           3.      Colinstl.com    Copies the colordos files from the
  783.                                     distribution disk to the destination
  784.                                     and determines the proper colordos
  785.                                     'driver' and removal utility to use
  786.                                     on your system. Also creates a DOS
  787.                                     batch file that will automatically
  788.                                     set system parameters and load
  789.                                     ColorDOS.
  790.  
  791.           4.      Colsetup.com    The ColorDOS setup utility. Enables
  792.                                     user customiztion of the default
  793.                                     colors.
  794.  
  795.           5.      Colordos.1      This is the file that colorizes the
  796.                                     command prompt.
  797.           6.      Colordos.2      Same as Colordos.com, except this
  798.                                     file also sends escape codes to the
  799.                                     ANSI.SYS driver
  800.           7.      Colordos.3      Also same as Colordos.com, except
  801.                                     it uses the video bios to write to
  802.                                     the screen.
  803.           8.      Colremov.1      Utility for removing Colordos or
  804.                                     Colansi from memory
  805.  
  806.           9.      Colordos.4      Performs the same job as Colordos for
  807.                                     systems with JP Software's 4DOS
  808.          10.      Colordos.5      Same as colordos.4, also sends ANSI
  809.                                     escape sequences.
  810.          11.      Colordos.6      4DOS version of Colordos.3.
  811.  
  812.          12.      Colremov.2      Utility for removing colordos.4, .5,
  813.                                   or .6 from memory.
  814.  
  815.          13.      Registr.frm     An order form
  816.  
  817.          14.      Vendor.doc      Information for disk vendors
  818.  
  819.          15.      Sysop.doc       Information for BBS Sysops
  820.  
  821.          16.      Sitelice.doc    Contains a fee schedule and licence
  822.                                     agreement for multiple computers
  823.                                     under one registration.
  824.  
  825.  
  826.  
  827.  
  828.  
  829. ColorDOS 1.5 User Manual                -14-          KroTek Electronics
  830.  
  831.                                 Appendix C
  832.  
  833.         This appendix contains information on manually setting the
  834. colordos and prompt environment variables. This should not be necessary,
  835. as the batch file does it automatically. This section is presented for
  836. those who want more in depth information or who want to set the
  837. environment from the command line.
  838.  
  839.                 C.1     ColorDOS Environment Variable
  840.  
  841.         Before ColorDOS loads itself into memory, it looks for a setup
  842. data file to tell it what colors to use. If it does not find this file,
  843. it will continue to load regardless, however it will use default color
  844. settings. The data file is called 'colordos.ini' and the environment
  845. variable 'COLORDOS' can be set in order to tell the program where this
  846. data file is located. Environment variables are set using the DOS 'set'
  847. command:
  848.  
  849.         set colordos=d:\path
  850.  
  851.         where d: is the drive in which the colordos.ini file is stored
  852. and "path" represents the subdirectory on that drive. Note that it is
  853. important not to leave any spaces on either side of the equals sign and
  854. the path name must actually exist.
  855.  
  856.         Environment variables can be set from the command line, however
  857. the best place to set them is in the autoexec.bat file. If the
  858. environment variable is not set, then ColorDOS defaults to looking in
  859. the root directory of 'C:' drive for colordos.ini.
  860.  
  861.         Do not add a file name to the variable, the file name
  862. 'colordos.ini' is automatically appended to the end of the path.  See
  863. your DOS documentation for further information regarding environment
  864. variables, the 'set' command, or the 'shell' command if you get an 'out
  865. of environment space' error message from DOS.
  866.  
  867.                 C.2     The Prompt Environment Variable
  868.  
  869.         The prompt environment variable should also be set. This is done
  870. by typing:
  871.  
  872.         prompt=$p$g
  873.  
  874.         where $p displays the current path and $g displays the
  875. terminating chevron ( > ) character. The prompt MUST end with a chevron,
  876. this is what ColorDOS uses to tell that it is at the end of the prompt.
  877. Also, there can be no carriage return/ linefeed commands ( $_ ) after
  878. the $p$g command in the prompt. The prompt environment variable can also
  879. be set from the command line or from autoexec.bat.
  880.  
  881.         ColorDOS will also run with the default DOS prompt (C>), or
  882. either upper or lower case 4DOS prompts. It is also OK to not set the
  883. 4DOS prompt enviroment and accept the default 4DOS prompt. (Upper case
  884. 4DOS prompts are specified by capitalizing the env variable ie $P$G,
  885. lower case can be obtained with $p$g. See your DOS or 4DOS manual for
  886. more information on various prompt options)
  887.  
  888. ColorDOS 1.5 User Manual                -15-          KroTek Electronics
  889.  
  890.                                 Appendix D
  891.  
  892.         Presented here is more detailed information on the function of
  893. the various 'driver' programs supplied in the ColorDOS package. As in
  894. the case of setting the prompt, the installation program automatically
  895. takes care of ensuring that the proper driver is renamed 'colordos.com'.
  896. However, it is also possible to perform this task manually by using the
  897. following proceedure.
  898.  
  899.  
  900.                 D.1     4DOS and ColorDOS
  901.  
  902.         4DOS, from JP Software, is an alternative command processor that
  903. replaces command.com. The following table shows the 4DOS ColorDOS files
  904. on the left along with their command.com equivalents.
  905.  
  906.              colordos.4   <==>  colordos.1
  907.              colordos.5   <==>  colordos.2
  908.              colordos.6   <==>  colordos.3
  909.              colremov.2   <==>  colremov.1
  910.  
  911.         If you are running 4DOS, then you must use the utilities on the
  912. left side of the table, the command.com versions will not work. They are
  913. equivalent in every other way, and you can freely substitute the 4DOS
  914. utilities on the left wherever you see the ones on the right printed for
  915. the rest of this appendix.
  916.  
  917.         You must have 4DOS version 3.00 or higher. If you are unsure of
  918. your version number, type the 'ver' command and the 4DOS version number
  919. will be listed along with the DOS version no.
  920.  
  921.  
  922.  
  923.                 D.2     Selecting the ColorDOS 'Driver'
  924.  
  925.         Let's start off here with a bit of a clean up. If you are using
  926. 4DOS, you can safely delete colordos.1, .2, and.3 and colremov.1.
  927. Similarly, command.com users can delete colordos.4 and above, as well as
  928. colremov.2
  929.  
  930.         The next decision is whether you have ANSI.SYS intalled. The
  931. best way to check is to look in your config.sys file for the statement
  932. 'device=ansi.sys'. If you do not have ansi.sys, or you do but decided
  933. that you don't want colordos to affect the text colors after the command
  934. prompt, then rename colordos.1 to colordos.com. If you do want different
  935. text colors for each different drive with ansi.sys installed, the you
  936. must rename colordos.2 to colordos.com. This is necessary because
  937. otherwise ansi.sys will overrule colordos' text colors with its own.
  938. Colordos.2 generates an escape sequence every time you change drives
  939. that puts ansi.sys' colors in phase with ColorDOS'.
  940.  
  941.  
  942.  
  943.  
  944.  
  945. 4DOS is a trademark of JP Software, Inc.
  946.  
  947. ColorDOS 1.5 User Manual                -16-          KroTek Electronics
  948.  
  949.         If you are undecided about whether you should install ANSI.SYS,
  950. - don't. ColorDOS works slightly better without it. ColorDOS does not
  951. store keyboard macros, etc., however, so there are lots of reasons why
  952. you might have it. If you have installed colansi.com and see something
  953. similar to this: '<-[1;34;40m' every time you change drives, then you do
  954. not have ansi.sys installed.
  955.  
  956.         If you notice that your text color is correct when you first log
  957. onto a drive, but then switches back to its previous color, you have
  958. ANSI escape sequences imbedded in your prompt, (ie your prompt is
  959. probably set similar to 'prompt=$e[1;34;40m$p$g) which must be removed.
  960. Escape sequences imbedded in the prompt will be generated each time the
  961. prompt is displayed, and will overrule ColorDOS', which is only sent the
  962. first time you log onto a new drive.
  963.  
  964.         Colordos.3 is simply another version of ColorDOS that uses the
  965. video bios instead of writing directly to the video buffer. You may find
  966. it useful if you do not have a totally compatible video card. In gen-
  967. eral, though, if the setup program ColSetup runs, then using Colordos.3
  968. should not be nesessary. If you need to use colordos.3, then rename it
  969. to colordos.com. Colordos.3 uses the /a command line switch to turn on
  970. the generation of ANSI.SYS escape sequences.
  971.  
  972.         Now you are ready to load ColorDOS into memory. To do this,
  973. simply run 'colordos' at the command prompt. You will get an
  974. installation message and your next prompt should be the colors you have
  975. selected.
  976.  
  977.         If you have DOS 4.0 or greater and a 80386 or 486 with upper
  978. memory installed, you can use DOS' 'loadhigh' command to place the
  979. memory resident portion of ColorDOS in upper memory. This will help keep
  980. the lower 640k of memory free for your applications programs. Once
  981. again, the ColStart batch file should automatically make proper use of
  982. the loadhigh command.
  983.  
  984.         See your DOS manual for information on emm386.exe, himem.sys,
  985. dos=umb, and loadhigh.
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006. ColorDOS 1.5 User Manual                -17-          KroTek Electronics
  1007.